home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / ronshead.zip / RONSHEAD.DOC < prev    next >
Text File  |  1992-08-29  |  8KB  |  293 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                         RonsHEAD
  24.  
  25.                                A TOMCAT! DISPLAY UTILITY
  26.  
  27.                                      Version  1.10
  28.                                     August 29, 1992
  29.  
  30.  
  31.                         (C) COPYRIGHT 1992 - All Rights Reserved
  32.  
  33.                                            by
  34.  
  35.                                      Ron van Rossum
  36.                                     Adenauerlaan 84
  37.                                   3137 JA  Vlaardingen
  38.                                     The Netherlands
  39.  
  40.                                   Data *31-10-4752961
  41.  
  42.  
  43.  
  44.  
  45.  
  46.           INTRODUCTION
  47.  
  48.  
  49.  
  50.           FEATURES
  51.  
  52.           RonsHEAD is a  tool for creating  a custom designed  opening screen
  53.           for  Tomcat!.   It  replaces  special  RonsHEAD  @  variables  with
  54.           configured values of  the current caller.   The program is  ment to
  55.           execute just before Tomcat! loads.
  56.  
  57.  
  58.  
  59.           SYSTEM REQUIREMENTS
  60.  
  61.           RonsHEAD does  not have  any special  hardware requirements  beyond
  62.           what is needed to setup and run your BBS software.  To run RonsHEAD
  63.           you need the WILDCAT! v3.5 type of BBS software and Tomcat! v3.5 as
  64.           QWK compatible Maildoor.
  65.  
  66.  
  67.  
  68.           LICENSING
  69.  
  70.           The RonsHEAD program  and its accompanying documentation  have been
  71.           released as freeware.   No registration or payment is  required for
  72.           the use of the program.
  73.  
  74.  
  75.  
  76.           WARRENTY
  77.  
  78.           The  author  specifically  disclaims all  warrenties,  expressed or
  79.           implied,  including  but  not  limited  to  implied  warrenties  of
  80.           merchantability and fitness for a paticular purpose and the program
  81.           license   granted  herein  in  particular,   and  without  limiting
  82.           operation of the  program license  with respect  to any  particular
  83.           application, use,  or purpose.   In  no event  shall the  author be
  84.           liable for any loss of profit,  lost savings, commercial damage, or
  85.           other incidental or concequential damages arising out of the use or
  86.           inability to use RonsHEAD even if the author, Ron van Rossum, or an
  87.           authorized distributor  of  the product  has  been advised  of  the
  88.           possibility of such damages, or for any claim by any other party.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.           -----------------------------------------------------------------
  103.           McBAUD! Productions - RONSHEAD.DOC                         Page 1
  104.  
  105.  
  106.  
  107.  
  108.  
  109.           SUPPORT
  110.  
  111.  
  112.  
  113.           Product support is available  through several channels.  To contact
  114.           the  author  with  questions,   suggestions,  problems,  or   other
  115.           comments,
  116.  
  117.  
  118.             ■  Call McBAUD! BBS at *31-10-4752961 and  leave a message to RON
  119.                VAN ROSSUM in the "MAIN BOARD" conference.
  120.  
  121.             ■  Leave  a message to RON  VAN.ROSSUM in the WILDCAT! conference
  122.                on ILink:
  123.  
  124.             ■  Drop a note via Mail to:
  125.  
  126.                Ron van Rossum
  127.                Adenauerlaan 84
  128.                3137 JA  Vlaardingen
  129.                The Netherlands
  130.  
  131.  
  132.           If  you have a  problem installing or  using the  software, and you
  133.           have read  this entire  User's Manual  (please do  read the  manual
  134.           before  requesting help),  then feel  free to request  help through
  135.           either of the channels mentioned above.  I will make an  attampt to
  136.           answer all mail received.
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.           -----------------------------------------------------------------
  166.           McBAUD! Productions - RONSHEAD.DOC                         Page 2
  167.  
  168.  
  169.  
  170.  
  171.  
  172.           GETTING STARTED
  173.  
  174.  
  175.  
  176.           FILES INCLUDED
  177.  
  178.           The RonsHEAD installation kit is distributed in a single compressed
  179.           library file, containing the following files:
  180.  
  181.  
  182.                RONSHEAD.EXE   The executable file.
  183.  
  184.                RONSHEAD.DOC   This documentation file.
  185.  
  186.                TOMCAT.ORG     Masterfile example
  187.  
  188.                MAIL.BAT       Sample batch file for running RonsHEAD.
  189.  
  190.  
  191.  
  192.           INSTALLATION
  193.  
  194.           The installation steps are simple;
  195.  
  196.             ■  Copy RONSHEAD.EXE to any directory in your DOS path.
  197.  
  198.             ■  Copy TOMCAT.ORG to any directory on one of your drives.
  199.  
  200.             ■  Copy MAIL.BAT to your WILDCAT! Home directory.
  201.  
  202.             ■  Edit MAIL.BAT  and let  the commandline for  RonsHEAD point to
  203.                the drive/directory where you have copied the file  TOMCAT.ORG
  204.                into.
  205.  
  206.  
  207.           WILDCAT!'s Home Directory is the one containing MAKEWILD.DAT.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.           -----------------------------------------------------------------
  229.           McBAUD! Productions - RONSHEAD.DOC                         Page 3
  230.  
  231.  
  232.  
  233.  
  234.  
  235.           RUNNING THE PROGRAM
  236.  
  237.  
  238.  
  239.           FULL SYNTAX
  240.  
  241.                RONSHEAD [d:][\path\]<masterfile>
  242.  
  243.  
  244.  
  245.           MASTER DISPLAY FILE
  246.  
  247.  
  248.           RonsHEAD is to be executed just  before the Maildoor Tomcat! loads.
  249.           It   first   collects   information   from  DOOR.SYS,   TOMCAT.CFG,
  250.           MAKEWILD.DAT, CONFDESC.DAT  and ALLUSERS.DAT.   It  then opens  the
  251.           masterfile as indicated on the  command-line and copies  it to  the
  252.           file TOMCAT.BBS in  the Display  directory of  the callers  current
  253.           conference.  While copying  it searches for 14 special  @ variables
  254.           and replaces them  with the  correct values as  collected from  the
  255.           files mentioned.
  256.  
  257.           The following variables are searched for and replaced;
  258.  
  259.                @TCDATE@ ..... Last date Tomcat! is used (follows  date-format
  260.                               from MakeWild, 10 characters).
  261.                @TCTIME@ ..... Last time  Tomcat is used  (format HH:MM, fixed
  262.                               lenght of 5 characters).
  263.                @PROT@ ....... Default transfer protocol (12 characters).
  264.                @PACKER@ ..... Default packer  to use  for compression  (fixed
  265.                               lenght of 30 characters).
  266.                @MAXCONF@ .... Maximum messages per  conference (5 characters)
  267. |              @MAXATT@ ..... Maximum attached files size  to include  (fixed
  268. |                             length of 5 characters).
  269.                @MAXDOWN@ .... Maximum  messages  per  download (5 characters)
  270.                @OWNMAIL@ .... Send Own Mail (YES/NO)
  271.                @NEWFILE@ .... Include New files (YES/NO)
  272.                @NEWBULL@ .... Include new Bulletins (YES/NO)
  273. |              @HANGUP@ ..... Hangup after .REP upload (YES/NO)
  274. |              @ATTACH@ ..... Include all attachments (YES/NO)
  275. |              @EXPORT@ ..... Allow private message export (YES/NO)
  276.                @FORMAT@ ..... Packet type (QWK/TXT)
  277.  
  278.  
  279.           As mentioned,  all variables  have fixed  lengths, so  there is  no
  280.           problems of shifting lines  if you use boxes in  your display-file.
  281.           Besides these variables  all of WILDCAT!'s  own color codes  can be
  282.           used to create a custom designed opening screen for your Mail door.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.           -----------------------------------------------------------------
  292.           McBAUD! Productions - RONSHEAD.DOC                         Page 4
  293.